<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"> <style>
	.KEYW {color: #933;}
	.COMM {color: #bbb; font-style: italic;}
	.NUMB {color: #393;}
	.STRN {color: #393;}
	.REGX {color: #339;}
	.line {border-right: 1px dotted #666; color: #666; font-style: normal;}
	</style></head><body><pre><span class='line'>  1</span> <span class="COMM">/**
<span class='line'>  2</span>  * Work with standard transactions.
<span class='line'>  3</span>  *
<span class='line'>  4</span>  * Standard transactions provide so-called "1.5 phase commit".  We can
<span class='line'>  5</span>  *   ensure that work is never lost, but there is a chance of confirmations
<span class='line'>  6</span>  *   being lost, so that messages may be resent.  Applications that use
<span class='line'>  7</span>  *   standard transactions must be able to detect and ignore duplicate
<span class='line'>  8</span>  *   messages.
<span class='line'>  9</span>  *
<span class='line'> 10</span>  * @name Tx
<span class='line'> 11</span>  * @exports Tx as api.Tx
<span class='line'> 12</span>  * @class
<span class='line'> 13</span>  */</span><span class="WHIT">
<span class='line'> 14</span> 
<span class='line'> 15</span> 
<span class='line'> 16</span> </span><span class="COMM">/**
<span class='line'> 17</span>  * Confirm transaction mode.
<span class='line'> 18</span>  *
<span class='line'> 19</span>  * This method confirms to the client that the channel was successfully
<span class='line'> 20</span>  *     set to use standard transactions.
<span class='line'> 21</span>  *
<span class='line'> 22</span>  * @name Tx#selectOk
<span class='line'> 23</span>  * @event
<span class='line'> 24</span>  * 
<span class='line'> 25</span>  */</span><span class="WHIT">
<span class='line'> 26</span> 
<span class='line'> 27</span> </span><span class="COMM">/**
<span class='line'> 28</span>  * Confirm a successful commit.
<span class='line'> 29</span>  *
<span class='line'> 30</span>  * This method confirms to the client that the commit succeeded.
<span class='line'> 31</span>  *     Note that if a commit fails, the server raises a channel exception.
<span class='line'> 32</span>  *
<span class='line'> 33</span>  * @name Tx#commitOk
<span class='line'> 34</span>  * @event
<span class='line'> 35</span>  * 
<span class='line'> 36</span>  */</span><span class="WHIT">
<span class='line'> 37</span> 
<span class='line'> 38</span> </span><span class="COMM">/**
<span class='line'> 39</span>  * Confirm a successful rollback.
<span class='line'> 40</span>  *
<span class='line'> 41</span>  * This method confirms to the client that the rollback succeeded.
<span class='line'> 42</span>  *     Note that if an rollback fails, the server raises a channel exception.
<span class='line'> 43</span>  *
<span class='line'> 44</span>  * @name Tx#rollbackOk
<span class='line'> 45</span>  * @event
<span class='line'> 46</span>  * 
<span class='line'> 47</span>  */</span><span class="WHIT">
<span class='line'> 48</span> 
<span class='line'> 49</span> 
<span class='line'> 50</span> 
<span class='line'> 51</span> </span><span class="COMM">/**
<span class='line'> 52</span>  * Select standard transaction mode.
<span class='line'> 53</span>  *
<span class='line'> 54</span>  * This method sets the channel to use standard transactions.  The
<span class='line'> 55</span>  *     client must use this method at least once on a channel before
<span class='line'> 56</span>  *     using the Commit or Rollback methods.
<span class='line'> 57</span>  *
<span class='line'> 58</span>  * @name Tx#select
<span class='line'> 59</span>  * @function
<span class='line'> 60</span>  * 
<span class='line'> 61</span>  */</span><span class="WHIT">
<span class='line'> 62</span> 
<span class='line'> 63</span> </span><span class="COMM">/**
<span class='line'> 64</span>  * Commit the current transaction.
<span class='line'> 65</span>  *
<span class='line'> 66</span>  * This method commits all messages published and acknowledged in
<span class='line'> 67</span>  *     the current transaction.  A new transaction starts immediately
<span class='line'> 68</span>  *     after a commit.
<span class='line'> 69</span>  *
<span class='line'> 70</span>  * @name Tx#commit
<span class='line'> 71</span>  * @function
<span class='line'> 72</span>  * 
<span class='line'> 73</span>  */</span><span class="WHIT">
<span class='line'> 74</span> 
<span class='line'> 75</span> </span><span class="COMM">/**
<span class='line'> 76</span>  * Abandon the current transaction.
<span class='line'> 77</span>  *
<span class='line'> 78</span>  * This method abandons all messages published and acknowledged in
<span class='line'> 79</span>  *     the current transaction.  A new transaction starts immediately
<span class='line'> 80</span>  *     after a rollback.
<span class='line'> 81</span>  *
<span class='line'> 82</span>  * @name Tx#rollback
<span class='line'> 83</span>  * @function
<span class='line'> 84</span>  * 
<span class='line'> 85</span>  */</span><span class="WHIT">
<span class='line'> 86</span> 
<span class='line'> 87</span> </span></pre></body></html>